home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 65.zip / BS1 part 65 / SuperJam v1.0c disk 3.adf / Accessories / arexx.doc next >
Text File  |  1992-01-14  |  3KB  |  99 lines
  1.  
  2.             The ARexx Accessory
  3.  
  4. Use the SuperJAM! Accessory to control SuperJAM! via other multi-tasking
  5. programs on your Amiga.  The ARexx Accessory is the exact same ARexx
  6. Accessory that comes with Bars&Pipes Professional.  Infact, it responds
  7. to the same commands, and answers to the same ARexx port name,
  8. "Bars&Pipes ARexx." However, it only reacts to a subset of the commands that
  9. Bars&Pipes responds to.
  10.  
  11. INSTALLATION
  12.  
  13. Please read chapter 12 in the SuperJAM! manual to learn how to install
  14. the ARexx Accessory in your Accessories window.  In order for ARexx to 
  15. install properly, you must have ARexx itself installed in your
  16. computer.
  17.  
  18. OPERATION
  19.  
  20. Once the ARexx Acessory is installed, it activates automatically. 
  21. Double-clicking on the ARexx icon reveals no control window.
  22.  
  23. The ARexx Accessory receives commands addressed to "Bars&Pipes ARexx."
  24. Each ARexx command is followed by an optional set of parameters.  Many
  25. commands receive time information in SMPTE, Beats & Measures, or
  26. MIDI Clocks.  The first parameter is "BEAT" or "SMPTE" or "CLOCK," so as
  27. to indicate the time information.  The second parameter is the
  28. actual time in the specified format.  For example, to locate a 
  29. particular point in the Song, three different commands may be used:
  30.  
  31. LOCATE BEAT measure.beat
  32.  
  33. LOCATE SMPTE hour.minute.second.frame
  34.  
  35. LOCATE CLOCK midiclock
  36.  
  37.     EXAMPLE:
  38.  
  39. ADDRESS "Bars&Pipes AREXX" LOCATE BEAT 1.4
  40.  
  41. ADDRESS "Bars&Pipes AREXX" LOCATE SMPTE 0,0,23,12
  42.  
  43. ADDRESS "Bars&Pipes AREXX" LOCATE CLOCK 300
  44.  
  45. The BEAT time parameter is in measures and beats.  The SMPTE time
  46. parameter is in hpours, minutes, seconds, and frames.  The CLOCK
  47. parameter is in MIDI Clocks.  There are 24 MIDI Clocks per quarter
  48. note, while SuperJAM! thinks in terms of 192 clocks per quarter note.
  49. By using the MIDI standard, we remain consistent with other
  50. applications.
  51.  
  52. Here is a description of each command:
  53.  
  54. To locate to a specific position in the Song:
  55.  
  56. LOCATE BEAT/SMPTE/CLOCK time
  57.  
  58. To read the current position in the Song:
  59.  
  60. LOCATE BEAT/SMPTE/CLOCK
  61.  
  62. To start playback at the current position in the Song:
  63.  
  64. START
  65.  
  66. To start playback at a specific position in the Song:
  67.  
  68. START BEAT/SMPTE/CLOCK time
  69.  
  70. To stop playback immediately:
  71.  
  72. STOP
  73.  
  74. To bring the SuperJAM! screen to the front:
  75.  
  76. TOFRONT SCREEN
  77.  
  78. Then to put it to the back:
  79.  
  80. TOBACK SCREEN
  81.  
  82. To wait until the Song reaches a specific point, forcing the ARexx
  83. caller to synchronize with SuperJAM!:
  84.  
  85. WAIT BEAT/SMPTE/CLOCK time
  86.  
  87. To set the SMPTE frame type:
  88.  
  89. FRAME 24/25/29/30
  90.  
  91. To read the SMPTE frame type:
  92.  
  93. FRAME
  94.  
  95. To read the current tempo:
  96.  
  97. TEMPO
  98.  
  99.